@filigran/chatbot 3.24.1 → 3.26.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 3.26.0
+
+### Minor Changes
+
+- dc615f7: Agent switcher (filigran-ui#530, ported here; Refs XTM-One-Platform/xtm-one#10910):
+  - `theme.menuSurface` (`--filigran-chat-menu-surface`): the menus' own fill, so a host pairs it with `surfaceHover` and the keyboard-active row of the agent switcher reads in dark as in light.
+  - `theme.menuActiveBorder` (`--filigran-chat-menu-active-border`): a 2px left track on the keyboard-active row, `--border-input-hover` by default.
+  - The track now draws: the active rule sets the track colour as a variable the row's border reads, so the row's own `border-left` shorthand no longer resets it to transparent.
+  - With no agent list (`apiEndpoints.agents: null`) and no agent page or dashboard link, the header draws the agent as a label: no chevron and no dead-end "Agent switching is not available here" popover.
+
+### Patch Changes
+
+- 4d583d2: fix(chatbot): render the panel's text in the design system's body face
+
+  The panel root's `--font-sans` reads the host's `--font-content-base` (IBM Plex Sans), then IBM Plex Sans by name, before the system stack. The `fontFamily` prop still wins. Refs XTM-One-Platform/xtm-one#10910.
+
+- fb196e5: In-progress cards and composer focus (Refs XTM-One-Platform/xtm-one#10910):
+  - The status card ("Thinking...", "Analyzing results (step N)..."), the reasoning card under it and the waiting card take the design system's card corner, `--radius-sm` (Paper and Card draw `rounded-sm`), instead of the 12px `--radius-md` that made them rounder than every other card of the host. `src/components/radius.test.ts` pins the three.
+  - The composer shows exactly one focus indicator, the design system's 2px ring around the box, whether the focus came from a click, Tab or the panel after a send: the text field draws no outline or ring of its own (a browser's native ring or a host's `textarea:focus` rule stacked a second, often orange, edge) and the box drops its hover border while focused. The ring still stands aside while the agent works (the working glow).
+
+## 3.25.0
+
+### Minor Changes
+
+- 66ba7c1: Move `@filigran/chatbot` from FiligranHQ/filigran-ui into this repository (`packages/filigran-chatbot`). The npm name, the public API and the peer dependencies are unchanged: consumers only bump the version. From this release on, the package is built, tested and published by this repository's release pipeline. Refs XTM-One-Platform/xtm-one#10910.
+
+### Patch Changes
+
+- 8792430: The card corner reads the host's 12px radius, not Tailwind's 6px: the panel no longer redeclares `--radius-sm` / `--radius-md`, so the host's corners reach it (filigran-ui#528, released there as 3.24.1). Refs XTM-One-Platform/xtm-one#10910.
+
 Notable changes to `@filigran/chatbot`, so a host can see what an upgrade brings
 before taking it.
 
@@ -8,16 +38,6 @@ the versions follow [semantic versioning](https://semver.org/spec/v2.0.0.html).
 This file starts at 3.10.0; earlier releases are on the
 [releases page](https://github.com/FiligranHQ/filigran-ui/releases).
 
-## 3.24.1 — 2026-11-11
-
-### Fixed
-
-- Every `chat-radius-md` surface (the status card under a working turn,
-  menus, dialogs, artifact cards) reads the host's 12 px design-system corner
-  again instead of Tailwind's 6 px: the stylesheet no longer declares
-  `--radius-sm` / `--radius-md` on `.filigran-chatbot`, so the host values are
-  not shadowed (#10910).
-
 ## 3.24.0 — 2026-11-11
 
 ### Changed
@@ -240,7 +260,7 @@ This file starts at 3.10.0; earlier releases are on the
 - The composer's warning also covers an agent the draft `@`-mentions that is
   not meant for chat, until the mention is removed.
 - With workspaces, the list's `Not in a workspace` group has a `New
-  conversation outside a workspace` button, beside each workspace's own.
+conversation outside a workspace` button, beside each workspace's own.
 - In a reply's "Working files" list, a file the same reply wrote again later,
   with the same name and kind of file (MIME type without its parameters, else
   the type label), carries a "Superseded" tag; its last version carries none.
@@ -299,9 +319,9 @@ This file starts at 3.10.0; earlier releases are on the
   conversation list and on a conversation that could not be loaded. The panel
   showed its generic message instead.
 - The status line has its own wording when it has no agent's name (`The agent
-  is answering…`, `Consulting an agent…`, `Transferring to another agent…`),
+is answering…`, `Consulting an agent…`, `Transferring to another agent…`),
   where it filled the name with a lowercase `the agent`: `the agent is
-  answering…` started without a capital. A host translating through `t` in a
+answering…` started without a capital. A host translating through `t` in a
   language the panel has no catalog for translates these three keys; it
   translated `the agent` before, and shows them in English until it does.
 - A host that can steer (a `steer` route, on by default) gets its conversation
@@ -349,9 +369,9 @@ This file starts at 3.10.0; earlier releases are on the
   conversation list and on a conversation that could not be loaded. The panel
   showed its generic message instead.
 - The status line has its own wording when it has no agent's name (`The agent
-  is answering…`, `Consulting an agent…`, `Transferring to another agent…`),
+is answering…`, `Consulting an agent…`, `Transferring to another agent…`),
   where it filled the name with a lowercase `the agent`: `the agent is
-  answering…` started without a capital. A host translating through `t` in a
+answering…` started without a capital. A host translating through `t` in a
   language the panel has no catalog for translates these three keys; it
   translated `the agent` before, and shows them in English until it does.
 - A conversation list that could not be read (a refusal, a server or network
@@ -413,7 +433,7 @@ This file starts at 3.10.0; earlier releases are on the
 - A row of the conversation list shows the last message
   (`last_message_preview`) under its title, and a small icon for a
   conversation started in a messaging channel (`channel`), named `Started in
-  {channel}`: Slack, Teams, WhatsApp, Telegram, Discord and Google Chat out
+{channel}`: Slack, Teams, WhatsApp, Telegram, Discord and Google Chat out
   of the box; `channelLabel(channel)` names another, or hides one (`null`).
   `ChatConversationSummary` gains the optional `lastMessagePreview` and
   `channel`.
@@ -427,7 +447,7 @@ This file starts at 3.10.0; earlier releases are on the
   takes a plain click on it; the chevron beside the name opens the agent
   picker then.
 - `clearAllAction: 'archive'` words Clear all as an archive (`Archive all
-  conversations`).
+conversations`).
 - `XtmAgent.badges`: short labels the agents list may send (`badges`, strings
   only), shown after the agent's name in the agent picker.
 - `toolLabels`: the host's names for its tools, by raw name or as a function
@@ -475,7 +495,7 @@ This file starts at 3.10.0; earlier releases are on the
   (`AgentStatusState.answeringAgentName`);
   `Transferring to {agent}…` on `transfer_start`; the setup step of
   `preparing` by its `phase` (`Loading conversation history…`, `Summarizing
-  earlier conversation…`, `Recalling memory…`, `Connecting integrations…`,
+earlier conversation…`, `Recalling memory…`, `Connecting integrations…`,
   `Preparing tools…`, else `Preparing…`); `Compacting conversation context…`;
   `Saving response…` on `persisting`; and `Analyzing results (step {step})…`
   from the frame's `iteration` after the first step. A host's `statusLabel`
@@ -487,7 +507,7 @@ This file starts at 3.10.0; earlier releases are on the
   `ChatMessage.interrupted`) is marked as a truncated one is, and its reasoning
   details say why.
 - A finished answer with no text and no files says `No response was
-  generated. Please try again.`; it showed `...`.
+generated. Please try again.`; it showed `...`.
 - A paste from an office suite or a spreadsheet (Excel, Word, PowerPoint,
   OneNote, LibreOffice, Numbers) puts the copied text in the composer. These
   apps copy a selection as its text, its HTML and a picture of it, and the
@@ -537,8 +557,8 @@ This file starts at 3.10.0; earlier releases are on the
   through every consult level, as an agent consulted may consult its own
   peers. It names the agent consulted and what the agent doing the work does
   (`Consulting {agent}: {tool}…`, `Consulting {agent}: {tool} (+{count}
-  more)…`, `Consulting {agent}: writing the answer…`), or `Consulting {count}
-  agents…` while several run (`Consulting {agent}: {count} questions…` when
+more)…`, `Consulting {agent}: writing the answer…`), or `Consulting {count}
+agents…` while several run (`Consulting {agent}: {count} questions…` when
   they ask one agent), and the consult's elapsed time runs on. Each consult is
   told apart by the frame's `consult_id`, else by the agent consulted. The
   consults end when the agent's own loop moves on, whether they answered or
@@ -636,7 +656,7 @@ This file starts at 3.10.0; earlier releases are on the
   `onConversationChange`), pick the agent selected first (`initialAgent`,
   `onAgentChange`) and drive the panel through its `ref`, a handle that is the
   same object for the panel's life:
-  - `send(text, { extras, displayText })`: the backend receives *text* with
+  - `send(text, { extras, displayText })`: the backend receives _text_ with
     `extras` in its body, and the user's bubble shows `displayText` (as with
     `onBeforeSend`'s, which wins when it gives one). It resolves to what
     became of the message: `'sent'` once the backend takes it, `'steered'`,
@@ -823,7 +843,7 @@ This file starts at 3.10.0; earlier releases are on the
 - A conversation whose restore answers 401 or 403 (expired credentials) keeps
   its id too, rather than being dropped for a new chat (a host's `?c=`
   survives): the panel shows the response's `detail` (or `This conversation
-  could not be loaded.`) with a Retry button, and reads the conversation back
+could not be loaded.`) with a Retry button, and reads the conversation back
   as soon as `requestHeaders` change.
 - A message the backend refuses before streaming (a non-2xx answer) shows the
   response's `detail` (a string, or the `message` or `detail` of an object)
@@ -846,7 +866,7 @@ This file starts at 3.10.0; earlier releases are on the
 - The composer's footer under a message that waits for the running turn
   (a reference, a mention) says `This message waits for the current response`,
   a new key, in place of `Referenced conversations wait for the current
-  response`.
+response`.
 
 ### Fixed
 

package/LICENSE

@@ -0,0 +1,203 @@
+Copyright (c) 2026 Filigran SAS
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Filigran SAS
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -27,7 +27,7 @@ Filigran chat panel — a standalone React + Tailwind chatbot component with SSE
 ## Installation
 
 ```bash
-yarn add @filigran/chatbot
+pnpm add @filigran/chatbot  # or: yarn add / npm install
 ```
 
 ## Quick Start
@@ -1626,33 +1626,25 @@ const { groups, unfiled } = groupConversations(
 
 ## Development
 
-To develop locally:
+This package lives in [XTM-Foundation/filigran-design-system](https://github.com/XTM-Foundation/filigran-design-system) (`packages/filigran-chatbot`), a pnpm workspace. It moved there from FiligranHQ/filigran-ui (last release published from there: 3.22.0); the npm name is unchanged.
+
+To develop locally, from the repository root:
 
 ```bash
-cd packages/filigran-chatbot
-yarn dev
+pnpm install
+pnpm --filter @filigran/chatbot dev
 ```
 
 To build:
 
 ```bash
-yarn build
+pnpm --filter @filigran/chatbot build
 ```
 
 To run the unit tests (Node's built-in test runner, with an esbuild loader for JSX and Node's own type stripping for TypeScript; Node 22.18 / 23.6 or later):
 
 ```bash
-yarn test
-```
-
-To publish:
-
-```bash
-yarn publish --access public
+pnpm --filter @filigran/chatbot test
 ```
 
-Or from the monorepo root:
-
-```bash
-yarn publish:filigran-chatbot
-```
+To release: add a changeset naming `@filigran/chatbot` to the pull request (`pnpm exec changeset`). The repository's release pipeline ("NPM release 1: Release PR", then "NPM release 2: Publish on merge") versions, publishes and tags it (`@filigran/chatbot@x.y.z`). Never publish by hand.

package/dist/index.d.ts

@@ -390,15 +390,27 @@ interface ChatPanelTheme {
     surfaceSubtle?: string;
     /** A row or a button under the pointer (`--filigran-chat-surface-hover`). */
     surfaceHover?: string;
+    /**
+     * The menus' panel (the agent switcher, the history, the prompt and mention lists): the design system's
+     * `--bg-elevation-highlight`, a step off `surfaceHover` so the keyboard-active row reads in both modes
+     * (`--filigran-chat-menu-surface`, `surfaceRaised` unset).
+     */
+    menuSurface?: string;
+    /**
+     * The 2px left track of the keyboard-active menu row, the design system's `--border-input-hover`
+     * (at least 3:1 against `menuSurface`), so the row reads whatever the hover fill
+     * (`--filigran-chat-menu-active-border`, `--border-input-hover` then the accent unset).
+     */
+    menuActiveBorder?: string;
     /** A text field: the composer (no fill unless set), a rename field, the feedback and approval comments (`--filigran-chat-input-surface`). */
     inputSurface?: string;
     /** The composer's corners, as the host's text fields draw theirs (`--filigran-chat-input-radius`, `radiusMd` unset). */
     inputRadius?: string;
     /** The composer's border under the pointer, the design system's `--border-input-hover`; none at rest (`--filigran-chat-input-border-hover`, `border` unset). */
     inputBorderHover?: string;
-    /** The small corner of every control, chip and avatar tile, the design system's `--radius-sm` (`--filigran-chat-radius-sm`, 4px unset). */
+    /** The small corner of every control, chip, avatar tile and in-progress card (status, reasoning, waiting), the design system's `--radius-sm` (`--filigran-chat-radius-sm`, 4px unset). */
     radiusSm?: string;
-    /** The card corner of every card, bubble, status indicator, menu and dialog, the design system's `--radius-md` (`--filigran-chat-radius-md`, 12px unset). */
+    /** The large corner of every bubble, menu and dialog, the design system's `--radius-md` (`--filigran-chat-radius-md`, 12px unset). */
     radiusMd?: string;
     /** The composer field's height at rest, before it grows with the text (`--filigran-chat-input-min-height`, two lines unset). */
     inputMinHeight?: string;